home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 26
/
Cream of the Crop 26.iso
/
os2
/
cinet117.zip
/
CINET.DOC
next >
Wrap
Text File
|
1997-05-29
|
10KB
|
283 lines
CitrusSoft BBS Internet Kit (c) copyright 1997 Tom Fotherby, all rights reserved
--------------------------------------------------------------------------------
Disclaimer
----------
All of the files in this package become the sole responsibility of the
user. The author of this product can not, and will not be liable for
any use, misuse, and/or damages caused by this product.
Features
--------
· 32-bit OS/2 Native programs
· Uses very little system resources
· Runs with both DOS & OS/2 BBS Software
· Easy to set up
· Fully Multi-Node Compatible
· FTP, IRC and Telnet doors
· The users love them!!
Requirements
------------
· An IBM/PC Computer (386 or better) running OS/2 v3 (or newer)
with IAK or TCP/IP v2.0+
· A Connection to the internet [Slip / PPP / Lan]
*note* A 28.8k Slip/PPP line will work great! :)
· Static IP is NOT required!
· A BBS! (They can also be run in Local mode, without a BBS)
Setting up
----------
A) Run the installation program (INSTALL.EXE) - it will de-archive
the doors into the specified directory, and create the necessary
configuration files.
B) You will need an OS/2 X/Y/Zmodem protocol for the FTP door to work
Properly - it is suggested that you use CE-XYZ/2 v1.01. (XYZ2_101.ZIP)
*note* The FTP Door comes pre-configured to work with CE-XYZ/2.
All you have to do is unzip XYZ2_101.ZIP.
C) Set up your BBS to run the doors.
Command Line parameters (optional) :
/L - Run the door locally
/D<path> - Specify the path to the drop file (ex. /Dc:\bbs\)
/N<node> - Specify which node this door is being run from (ex. /N1)
[This is required for Multi-Node usage!]
/H<handle> - Have the door use an open (hot) ComPort Handle
/I<idle> - The amount of time the user can be Inactive in the door
Before the door quits back to the BBS
/T<time> -*Specify how much time the user can have in the door
/S<server> - Specify the IRC server to connect to
[Use "/Sask" to prompt the user for an irc server name]
/P<port> - Specify the Port at which to connect to
/U - Use "Alias" on line #36 of door.sys (if available)
/A<ip> - Specify your IP address (if having problems w/DCC or FTP)
/K - Keep the DCC'd files when the door exits
/O - Disable logging in the FTP/Telnet doors
( * = registered version only )
The /A parameter would be useful for systems that are running via
Masquerading IP.
[ setting up with an OS/2 native BBS software ]
Setting the doors up with an OS/2 BBS software is rather simple!
Take, for example, Synchronet BBS Software for OS/2.
A) Add an "Online Program".
B) Have it create a DOOR.SYS drop file in the NODE directory.
C) For the "Startup Directory", put the same directory as you installed
the doors into via INSTALL.EXE
D) For the "Command Line", put: telnet /n%# /dc:\sbbs\node%#
(in Synchronet BBS, %# is the macro for the node number)
E) Add "TELNET" to the "OS/2 Programs List"
F) Repeat the above steps for the IRC and FTP doors.
[ setting up with a DOS BBS software ]
If you are using a DOS BBS software, you will need to use the freeware
program "HSTART". (included in this package - hstart05.zip).
The following configuration assumes that you've unzipped the CitrusSoft
BBS Internet Kit into "C:\CINET"!
Create the following files:
CINET.BAT, containing:
----
@echo off
hstart.exe "%1 door" /fs /wait c:\cinet\cinet.cmd %1 %2 %3 %4 %5
----
CINET.CMD, containing:
----
c:
cd\cinet
%1.exe %2 %3 %4 %5
hwait.exe
exit
----
Now, instruct your BBS program to load cinet.bat with the parameter of
telnet, ftp, or irc (depending on which one you want it to load).
example:
CINET.BAT telnet <additional parameters, such as /Dc:\bbs ..etc.>
For more information on HSTART, refer to hstart.txt.
Configuration Files
-------------------
You may edit the following files with your favorite text editor when
changing them. Instructions for making modifications reside in each
file.
FTP/TELNET/IRC.CFG
~~~~~~~~~~~~~~~~~~
These are the main configuration files for the doors. They are used
to specify the BBS Name, Sysop Name, Drop file type, and Idle minutes.
There are also special options for each door.
Line #5 in FTP.CFG allows you to configure your hostname (for anon logins)
Line #5 in TELNET.CFG allows you to toggle the local screen IO (on/off)
Line #5 in IRC.CFG allows you to toggle DCC file transfers (on/off)
PROTOCOL.CFG
~~~~~~~~~~~~
This file allows you to customize/add/change file transfer protocols
in the FTP Door.
CHANNELS.TXT
~~~~~~~~~~~~
This is the file that gets presented to the user when they use /LIST
in the IRC Door. If this file doesn't exist, the IRC Door will get
the list of channels from the IRC Server (on the larger servers, such
as EFFNet or UnderNet, this may take a long time!)
SERVERS.TXT
~~~~~~~~~~~
This is the list of "default" IRC Servers that the user can connect to.
LOCKOUT.TXT
~~~~~~~~~~~
You can use this file to put keywords, or partial channel names of channels
that you don't want the users accessing. (this is useful to keep the users
out of channels that provide porn, or whatever, via dcc)
*.SCR
~~~~~
These are scripts for the Telnet door. You can create and use these to
automatically log into different servers and such.. Check out the included
script, WWW.SCR, it will automatically log into the LYNX (www) program at
"public.sunsite.unc.edu"!
A note about Servers
--------------------
A server (Also known as a Site or Host) is 2 or more words, separated by
a period, and usually ends in .COM, .ORG, .EDU, .NET or .GOV.
If a FTP server is preceded with a 'ftp://', it will automatically log the
user in anonymously. Also, if a directory is specified on the end, it will
change to that directory once logged in. (ex: ftp://ftp.cdrom.com/pub)
Sysop Keys
----------
ALT C, Chat with the User
ALT +, Give the User time
ALT -, Take away time
Having problems?
----------------
If OS/2 pops up a box saying that the COM Port is allready in use when a
user enters the door, you'll need to add the ",-" parameter to SIO.
(Refer to Appendix D. of SIOREF.TXT)
If the door says that it is unable to Initialise the COM Port, you may
have to pass the COM Port handle from the BBS Software to the door.
(Refer to your BBS Software's documentation for information on how to do this)
If the FTP Door returns errors such as "Connection timed out" or
"Cannot build data connection" and the DCC function in the IRC Door has
trouble sending files, you will need to specify "/A<your-ip-address>" on
the command line. Example: ftp /A206.84.198.150 (other parameters go here)
Contacting the Author
---------------------
If you...
A) Need additional help setting up and configuring these doors
B) You want to report a problem / bug
C) You have suggestions
D) Just want to talk
You can contact me either via E-Mail or my BBS.
E-Mail: enigma@ees.eesc.com
BBS: The O-Zone BBS
Telnet: ozbbs.ml.org (ip address: 206.84.198.150)
Dialup: (248) 651-6472
Logon as NEW
Mail: Tom Fotherby
3535 Hadden
Rochester, MI 48306
USA
(for quickest response, use e-mail :)
Registration
------------
You are givin a 30-day evaluation period to test out the CitrusSoft
Internet Kit. After your 30-day trial period, you must decide whether
or not you wish to continue using it. If you find that these programs
meet your needs, you are required to register.
Registration is a One-time fee of $45 (U.S. Dollars). All future
Upgrades will be made available to registered users at no charge.
Benefits of Registration:
· No 10-minute time limit
· All of the 'registered' features will be enabled
· The Delays will be removed.
Types of payment accepted: Check or Money Order.
( Sorry, we do not accept Credit Cards )
Please make the Check or Money Order out to: Tom Fotherby, along with your
name and BBS Name, to:
Tom Fotherby
3535 Hadden
Rochester, MI 48306
USA
Specify where you'd like to receive the registered versions of the doors.
I can send them either via E-Mail, or File Attach on my BBS.
If you would like to receive it via Snail-Mail on a 3.5" floppy disk,
include an additional $2.00.
Whats New in Version 1.17?
--------------------------
A) Local Screen IO is about 10x faster! (New VIO Buffering techniques)
B) IRC: Optimized the DCC Code
C) IRC: If CHANNELS.TXT doesn't exist, /LIST will get the channel list from
the IRC server.
D) IRC: Ability to disallow access to certain irc channels (see LOCKOUT.TXT)
E) Telnet: Scripting capabilities in the Telnet door! Refer to CINET.DOC
and WWW.SCR for more info.
E) Added parameter /O. This will disable creating the .LOG files in the
Telnet and FTP doors.
F) Telnet: Fixed a bug which caused Z-Modem and other transfer protocols
to fail.
Whats New in Version 1.16?
--------------------------
A) The parameter /? (or -?) will bring up a list of Commandline Parameters
For each door.
B) Fixed a bug where the FTP & IRC Doors wouldn't delete the temporary files.
C) Added parameter /K. Using this parameter will SAVE the files, instead
Of deleting them when the door exits.
D) Added parameter /U. This will tell the door to use the Alias on line
#36 of the DOOR.SYS file, if available. (Useful for PCB & RA systems)
Whats New in Version 1.1
------------------------
A) The doors now use 2 methods of finding the local IP address. On some
systems gethostid() would return 255.255.255.255 for the local IP,
causing the FTP door to function improperly (Cannot Build data connection).
If it can't get the local IP by gethostid(), it will run "netstat.exe -a"
to get the correct local IP.
B) BugFix: The IRC door's "/DCC LIST", sometimes it wouldn't display
the correct SENT/RECEIVED bytes.
C) The IRC & FTP doors now clean up after themselves by deleting all
temporary and received files.
D) BugFix: Using ALT-C (chat) in the FTP Door would sometimes cause a
runtime error.
E) The IRC Door will now be able to connect to servers that require pIdentD
to be installed.